org.eclipse.vtp.framework.util
Interface SingletonTrackerCustomizer

All Known Implementing Classes:

HttpConnectorManager, LogTracker, ProcessEngineManager, SingletonTracker

public interface SingletonTrackerCustomizer

A customizer interface for the SingletonTracker class.

Since:

3.0

Version:

1.0

Author:

Lonnie Pryor

Method Summary

java.lang.Object	changingSelectedService(org.osgi.framework.ServiceReference oldReference, java.lang.Object oldService, org.osgi.framework.ServiceReference newReference) Called when another service besides the currently selected singleton is selected as the new singleton.
void	releasedSelectedService(org.osgi.framework.ServiceReference reference, java.lang.Object service) Called when the selected service must be released and no replacement is available.
void	selectedServiceModified(org.osgi.framework.ServiceReference reference, java.lang.Object service) Called when the properties of the currently selected singleton service have changed.
java.lang.Object	selectingService(org.osgi.framework.ServiceReference reference) Called when a service is selected as the singleton.

Method Detail

selectingService

java.lang.Object selectingService(org.osgi.framework.ServiceReference reference)

Called when a service is selected as the singleton.

Parameters:

reference - The selected singleton service reference.

Returns:

The singleton service object or null if the specified reference should not be selected.

changingSelectedService

java.lang.Object changingSelectedService(org.osgi.framework.ServiceReference oldReference,
                                         java.lang.Object oldService,
                                         org.osgi.framework.ServiceReference newReference)

Called when another service besides the currently selected singleton is selected as the new singleton. Implementations must release the old singleton if the new singleton is accepted.

Parameters:

oldReference - The currently selected singleton service reference.

oldService - The currently selected singleton service object.

newReference - The newly selected singleton service reference.

Returns:

The new singleton service object or null if the new reference should not be selected and the old reference should be maintained.

selectedServiceModified

void selectedServiceModified(org.osgi.framework.ServiceReference reference,
                             java.lang.Object service)

Called when the properties of the currently selected singleton service have changed.

Parameters:

reference - The currently selected singleton service reference.

service - The currently selected singleton service object.

releasedSelectedService

void releasedSelectedService(org.osgi.framework.ServiceReference reference,
                             java.lang.Object service)

Called when the selected service must be released and no replacement is available.

Parameters:

reference - The currently selected singleton service reference.

service - The currently selected singleton service object.